home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archivers / CCB / CCB.readme < prev    next >
Text File  |  1996-09-26  |  15KB  |  337 lines
  1. Short:    GUI for archivers LhA,LZX,DMS,DSQ v1.5
  2. Uploader: johnw@kvnet.org (John Wells)
  3. Author:   johnw@kvnet.org (John Wells)
  4. Type:     util/arc
  5.  
  6.                    Compressor Control Box - v1.5
  7.                            Feb 12, 1996
  8.                            by John Wells
  9.  
  10.  
  11. This program is Copyright 1996 by John Wells.  All Rights Reserved.
  12. This program may not be sold, although a small charge for shipping,
  13. handling, and media may be charged.
  14.  
  15. This  program is a convenient interface for using several disk/file
  16. archivers.    Currently, Compressor Control Box (hereafter known as
  17. CCB) supports the following archivers: LZX, LHA, DMS, and DSQ.
  18.  
  19. First, a disclaimer:
  20.  
  21. The  purpose  of this program is to compress the contents of floppy
  22. disks,  hard  drives,  and  other  forms of temporary and permanent
  23. computer  storage.    The  author,  John  Wells,  will  not be held
  24. responsible  for  any  data lost through the (correct or incorrect)
  25. use  of  this  program,  nor  will  he  be held responsible for any
  26. damages  (financial  or  otherwise)  resulting from the use of this
  27. program.
  28.  
  29. General Info:
  30.  
  31. Ok,  so  what  are  these  compressors?   Quick summary.  LhA is an
  32. archiver  that  takes  groups of files and compresses them into one
  33. single  file,  thereby reducing the total size and making it easier
  34. to  store  said files.  LZX is the latest generation file-archiver,
  35. featuring  faster  and  better  compression  than  LhA.   DMS is an
  36. archiver  designed  to compress entire disks, resulting in a single
  37. file  that  is  easier  to  store  and  transfer.    DSQ (short for
  38. DiskSqueeze!),  is  the  modern-era  disk  compressor.    Dirk Vael
  39. originated  the  concept with DiskSqueeze!, and I was hooked.  More
  40. reliable  than  DMS, it also features better compression, using LZX
  41. and PackDev.  I have not done a full implementation of DiskSqueeze!
  42. here,  for  that,  please  get  the original by Dirk Vael.  Look on
  43. Aminet under util/arc for the latest version.
  44.  
  45. Requirements:
  46.  
  47. I'm  not sure, but I don't think CCB will run on pre-2.04 systems. 
  48. I don't know anyone still using 1.3!  It does work on 2.04 thru 3.1
  49.  
  50. DMSDescript (v1.1)     (Included)         View/Add File_id.diz to DMS files
  51. PackDev (v1.7)         (Included)         (De)Compress DiskSqueeze!  files
  52. DirII                 (Included)         Create Files.dsq for DiskSqueeze! 
  53. DMS (v1.11+)         (Not included)     (De)Compress DMS files
  54. LhA (v1.38e+)         (Not included)     Manipulating LHA files
  55. LZX (v1.20e+)         (Not included)     Manipulating LZX and DiskSqueeze! 
  56.                                     files
  57.  
  58. In  order  to use the supported archivers, it is important that CCB
  59. be  able to find them.  A good place for them is your C: directory.
  60.  
  61. CCB has been extensively tested using the following: LhA v1.38e and
  62. v1.50r,  LZX  v1.20e,  and DMS v1.11.  I would think that any newer
  63. versions of those programs would work just fine as well.
  64.  
  65. CCB also requires the cando.library, v2.511+, which is NOT included
  66. in  this distribution, as I am not sure of the distributability (is
  67. that a word?) of the library.  However, since v3.006 of the library
  68. IS  freely  distributable,  I  have included it to make the package
  69. complete.
  70.  
  71. To  make  things  a  bit easier, just click on the included INSTALL
  72. icon to put the included programs (DMSDescript, DirII, and PackDev)
  73. in your C: directory.
  74.  
  75. ToolTypes:
  76.  
  77. CCB currently supports the following tooltypes:
  78.  
  79.     SOURCE=default source path.  Default is DH1:Files
  80.     DESTINATION=default destination path.  Default is DH1:Temp
  81.     TDIR=default Temporary T: path.  Default is DH1:T
  82.     VIEWER=default text viewer.  Default is C:MultiView
  83.  
  84. CLI Usage:
  85.  
  86. not currently supported (it's an interface.  That's the point!)
  87.  
  88. Workbench Usage:
  89.  
  90. If you want to see what is happening, I would use the CCB icon, but
  91. if  you  don't  need  to  see  what  is going on, just click on the
  92. CompressorControlBox  icon.    The  only difference is that the CCB
  93. icon  also  opens  up  an  output  shell,  so  you  can see what is
  94. happening.    I  have  noticed  no noticeable speed increase in NOT
  95. opening the shell, so it's a matter of personal choice.
  96.  
  97. I've  tried to make it as easy to use as possible.  Just follow the
  98. 5 steps shown on the interface, and you'll be set.  In order, these
  99. are:
  100.  
  101. 1) Select Compressor.  LhA, LZX, DMS, DSQ, LhA-2-LZX, or DMS-2-DSQ
  102.  
  103.     LhA-2-LZX and DMS-2-DSQ perform the conversion process in the
  104.     T:  directory.    I have found that you will need about 2.5 meg
  105.     free  for converting a DMS file to an DSQ file, and about 1 1/2
  106.     times  the  size of the LhA file for converting an archive from
  107.     LhA  format  to  LZX.    If  you  don't  have  enough memory to
  108.     transform the file, I suggest assigning T: to somewhere on your
  109.     harddrive.   It will slow things down somewhat, but unless your
  110.     HD  is  REALLY  cramped,  you  should have enough room there to
  111.     perform the conversion.  Also, when converting from DMS to DSQ,
  112.     I  strongly  recommend  using  RAD or an FMS-type drive for the
  113.     work drive.  It will work using a standard floppy, but it is SO
  114.     SLOW!    Do  yourself  a favor, and install FMSdisk today!  The
  115.     LhA-2-LZX  and DMS-2-DSQ options also offer a 'batch' mode, for
  116.     converting  many  files  all  at once.  Unlike the 'single file
  117.     mode',  batch  conversion does not show the resulting file-size
  118.     difference  between  the  original  and new files, or offer the
  119.     chance  to  delete  one.  All selected files will be processed,
  120.     keeping  the  originals intact, unless an error is encountered,
  121.     which  will  stop  the  conversion  process.  Each file will be
  122.     shown  in the 'Source' box as it is being processed, and if the
  123.     conversion fails, that entry will remain shown in the box.
  124.     
  125.  
  126. 2) Select Operation.  Compress, DeCompress, Test, View/Add Diz
  127.  
  128.     View/Add Diz works as follows.  If the file you checked doesn't
  129.     have a File_id.diz, CCB will open up a little window for you to
  130.     enter  the  description  into.   When you are finished entering
  131.     text,  hit 'ESC x' to close the window and save the File_id.diz
  132.     to  the  file.  If the file DOES have a File_id.diz attached to
  133.     it,  it  will be displayed and you will be given an opportunity
  134.     to modify it.
  135.     
  136. 3) Select Source File/Dir/Device.
  137.  
  138.     Click on this, a requester comes up, allowing you to select the
  139.     SOURCE  F/D/D.   When using DMS or DSQ, a requester will pop up
  140.     asking  for the source device, such as DF0 or DF1, at the right
  141.     time.   Don't worry, you'll know it when it happens!  Just make
  142.     sure there is a disk in the drive BEFORE you click on Start!
  143.    
  144. 4)  Select Destination.
  145.  
  146.     Another requester.  When using DMS or DSQ, a requester will pop
  147.     up  asking  for  the destination device, such as DF0 or DF1, at
  148.     the  right time.  Don't worry, you'll know it when it happens! 
  149.     Just make sure there is a disk in the drive BEFORE you click on
  150.     Start!
  151.  
  152. 5) Process Selection.  Start or Reset All
  153.  
  154.     Reset All clears the current selection.
  155.  
  156.     If  you  are  DeCompressing  an LhA or LZX archive, a requester
  157.     will pop-up, asking if you would like to create a drawer to put
  158.     the  contents  into.   This keeps things from getting scattered
  159.     all  over your drive, and makes it easy to get rid of files you
  160.     decide not to keep.
  161.     
  162.  
  163. Want  more  info?    OK,  you've  got  it.   If you select the Test
  164. operation, no need to select a destination.  Makes sense, right? 
  165.  
  166. If  using DSQ, I strongly suggest assigning T: to somewhere on your
  167. harddrive,  as  it  can  use  up to 2 meg of RAM while processing a
  168. file.    Of  course,  if  you have 3 megs or more free, don't worry
  169. about it.  The little memory display in title bar should give you a
  170. clue as to whether or not you need to re-assign T: to your HD
  171.  
  172. That's  it!  If you have any questions or comments, or just want to
  173. send  a  donation  (A4000,  Corvette,  book, game, money, whatever)
  174. please feel free to get in touch with me at the address below.
  175.  
  176.                             John Wells
  177.                          2595 Vonoa Drive
  178.                         Radcliff, KY 40160
  179.         
  180.                       e-mail: johnw@kvnet.org
  181.  
  182.  
  183. Registration Info:
  184.  
  185. Registration  is  simple.  I'm not picky.  I will accept just about
  186. anything  you  consider to be of value.  For example, I will gladly
  187. accept  a  registered  version  of  a  program  YOU have written in
  188. exchange  for the registered version of Compressor Control Box.  If
  189. the exchange is handled via e-mail, I will continue to send updates
  190. as  they  are  created, with no further fee due.  Naturally, I will
  191. not turn down monetary offers, or boxes of cookies, a CD, whatever.
  192. I  will  supply the registered version ONCE by floppy, if you would
  193. prefer  to  do  it  that  way.    Updates will ONLY be sent out via
  194. e-mail.    So  be  sure  to  give  me  your e-mail address when you
  195. register. 
  196.  
  197.                 Greetings, Thanks, and Other Stuff
  198.  
  199.     I  would  like  to thank those who have sent me e-mail, for the
  200.     kind   words   and   support   (and   suggestions!), especially
  201.     ashley@apowell.demon.co.uk, who was the very first to send me a
  202.     message regarding CCB.
  203.     
  204.     I would also like to extend my thanks to the following:
  205.  
  206.         Ashley, for making the excellent AmigaGuide for CCB
  207.  
  208.                   Stephen Davies, author of DirII
  209.  
  210.                    Stefan Boberg, author of LhA
  211.   
  212.                   Jonathan Forbes, author of LZX
  213.    
  214.                   SDS Software, author(s?) of DMS
  215.   
  216.                 Dirk Vael, author of DiskSqueeze! 
  217.  
  218.                 Christian Wasner, author of PackDev
  219.  
  220.              Jay Miner for creating a REAL computer! 
  221.  
  222.               Amiga Technologies for resurrecting Amy
  223.    
  224.              INOVAtronics, Inc., developers of CanDo!
  225.             
  226.        Re/Y\o(/Y\ystic/X-DeSign), author of DMSDescript v1.1
  227.  
  228.  
  229.  
  230.                               HISTORY
  231.  
  232. v1.5 -    12 Feb 96
  233.  
  234.         Added  'batch  mode'  to  the   LhA-2-LZX   and   DMS-2-DSQ
  235.         conversion  routines,  added  tooltype support for defining
  236.         the  Source,  Destination  and temporary T: directories, as
  237.         well  as  the  ability to define where your favorite viewer
  238.         is.    If the ToolTypes are not found, the defaults of SYS:
  239.         and  C:MultiView  will  be  used.    Moved  the  'Free Mem'
  240.         indicator  from  the window title bar to it's location next
  241.         to  the   'Select   Compressor'   text   for   legibility. 
  242.         Re-arranged  the  'History'  in  this document, to show the
  243.         latest info at the top, removed the use of DLDiz (no longer
  244.         needed), and enhanced the error-detection routines.
  245.  
  246. v1.4 -    30 Jan 96
  247.  
  248.         Ok,  cleaned  up the GUI, think I have the docs pretty well
  249.         squared  away  now.    I  have (I think) complied with Dirk
  250.         Vael's  request  to  dump  xDM  and   switch   support   to
  251.         DiskSqueeze!,  I  hope  he likes the way it has turned out.
  252.         Fixed  a  bug  in  the  creation  of  a  new   drawer   for
  253.         decompressing  lha  and  lzx  archives (thanks for spotting
  254.         that,  Ashley!),  fixed  the  constant  re-drawing  of  the
  255.         program window, added the ability to delete the original or
  256.         the new when converting from lha-to-lzx and when converting
  257.         from  DMS-to-DSQ.  Added a bunch of progress indicators, so
  258.         you  won't  think  things are frozen when converting files,
  259.         fixed  the  memory  indicator  (I  hope),  added a means of
  260.         assigning  T:  to  the hard drive if low on memory, fixed a
  261.         serious  bug in the DMS and DSQ routines (I won't tell what
  262.         it  was.   If you found it, you know what it was).  Changed
  263.         the  'Abort'  button  to  'Reset All', which is what it was
  264.         originally  supposed  to do (and now does).  There might be
  265.         more,  but  after  3  days sitting in front of Amy, I can't
  266.         seem  to remember!  I would like to especially thank Ashley
  267.         for doing the AmigaGuide for CCB.  Looks great!
  268.  
  269. v1.31 - 27 Jan 96
  270.  
  271.         This  was  an emergency release, disabling the xDM portions
  272.         of  CCB.   I received a message from the originator of xDM,
  273.         Dirk  Vael,  asking  me to remove xDM from the program.  In
  274.         haste,  I simply disabled those functions pertaining to xDM
  275.         and sent it out, to replace the v1.3 release.  I'll get the
  276.         GUI and docs cleaned up for the next release.
  277.  
  278. v1.3 - 20 Jan 1996
  279.  
  280.         Finally  found  a  way  to  make  LhA  and  LZX  compress a
  281.         directory  and  include  the selected path ONLY, as well as
  282.         the  .info for the drawer (if it exists).  What this means,
  283.         is  that  you will no longer have files that un-compress to
  284.         something   like:    WorkBench:Games/FavoriteOfAllTime/blah
  285.         Instead,  if  you  had  elected  to   compress   the drawer
  286.         'FavoriteOfAllTime/',  containing  'blah' and such, it will
  287.         actually  only  have  the path of 'FavoriteOfAllTime/blah',
  288.         just  like it should!  Also, I finally got around to fixing
  289.         up  some  of the pull-down menus, take a look at them.  One
  290.         more thing.  I found the program 'DMSDescript', which means
  291.         that you can now View/Add a File_id.diz to DMS files.
  292.  
  293. v1.3 - FIRST REGISTERED VERSION
  294.  
  295.         I  decided to make the LhA-2-LZX and DMS-2-xDM options only
  296.         available  to registered users, have to give them some kind
  297.         of  benny  for  registering!    Since  v1.0  - v1.2 did not
  298.         support  this  repacking option, it looks like v1.3 will be
  299.         the  first  to  give  the  un-registered users something to
  300.         think  about.  I find the option VERY handy, since it is SO
  301.         EASY TO USE!  So come on, folks, go ahead and register.  It
  302.         really is worth it!  :)
  303.  
  304. v1.2 - 14 Jan 1996
  305.  
  306.         Spruced  up  the  appearance  of  the GUI somewhat, added a
  307.         pop-up  requester  to the DeCompress option of LhA and LZX,
  308.         to  ask  the  user if a drawer should be created to put the
  309.         contents  into.  Straightened up some code, got rid of some
  310.         excess,  added  the  'About' menu item.  Just little stuff,
  311.         really.  Oh, and I cleaned up this readme, too!
  312.         
  313. v1.1 - 9 Jan 1996 
  314.  
  315.         Finally  found  a  way  to  fix  the  niggling problem with
  316.         selecting  the device to use for DMS and xDM.  The user can
  317.         now select ANY floppy-type device for use by CCB.
  318.  
  319.         Added  a  'history'  function  to  the   source/destination
  320.         requesters,  so  that  the  last directory used will be the
  321.         default (hope that is what you had in mind, Ashley!)
  322.  
  323.         Fixed  the  'View/Add  Diz'  option,  can  now   view   the
  324.         File_id.diz of LZX, LhA, DMS, and xDM archives, and can add
  325.         a  File_id.diz  to LZX, LhA, and xDM files.  Sorry, nothing
  326.         for DMS (yet!).
  327.  
  328.         Added  a  Memory display to the title bar, good for keeping
  329.         track of just how much ram you have left after crunching up
  330.         several disks or directories.
  331.  
  332.  
  333. v1.0 - 1 Jan 1996
  334.  
  335.       Initial release
  336.  
  337.